home *** CD-ROM | disk | FTP | other *** search
/ Ultimedia 1 / Ultimedia 1.iso / tools / grafiktools / djpeggui / djpeggui.doc < prev    next >
Text File  |  1993-07-25  |  9KB  |  305 lines
  1. $VER: djpegGUI.guide 37.1 (25/07/93)
  2.  
  3.  
  4.                     Documentation for djpegGUI 37.1
  5.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  6.                          Date: July 25, 1993
  7.  
  8.                         Author: Geoff Seeley
  9.  
  10.  
  11. I.    Preface         - About the program.
  12. II.   Copyrights      - Important information.
  13. III.  Acknowledgments - Who made it possible.
  14. IV.   Installation    - Setting up on your system.
  15. V.    Menus           - Menu descriptions.
  16. VI.   Gadgets         - Gadget descriptions
  17. VII.  Known Bugs      - What doesn't work
  18. VIII. Program History - What was done to fix above :-)
  19.  
  20.  
  21.  
  22. Section I. - Preface
  23. ~~~~~~~~~~~~~~~~~~~~
  24.  
  25.  
  26.    djpegGUI is an Intuition front end to the Independent JPEG Group's
  27.    JPEG decompression software. ("djpeg")
  28.  
  29.  
  30.    djpegGUI will run under Kickstart 2.04 and above only.
  31.  
  32.  
  33.  
  34. Section II. - Copyrights
  35. ~~~~~~~~~~~~~~~~~~~~~~~~
  36.  
  37.  
  38.    djpegGUI is freely distributable and may not be sold for profit, however
  39.    djpegGUI remains copyrighted © 1993 (All rights reserved) by Geoff Seeley.
  40.  
  41.  
  42.    djpegGUI may be included in public domain libraries such as Fred Fish's 
  43.    "Amiga Freely Redistributable Library" as long as no profit is made from 
  44.    this program and no files in the archive are modified in any way.
  45.  
  46.  
  47.    No warrantees are expressed or implied for this program. Use it at your
  48.    own risk.
  49.  
  50.  
  51.    Parts of this archive ("djpeg" and "djpeg.man") are based in part on the 
  52.    work of the Independent JPEG Group.
  53.  
  54.  
  55.    AmigaGuide, Commodore's Installer and Workbench are copyrighted trademarks
  56.    of Commodore-Amiga, Inc.
  57.  
  58.  
  59.  
  60. Section III. - Acknowledgements
  61. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  62.  
  63.  
  64.    The following people and groups made this program possible. Thanks go to:
  65.  
  66.  
  67.       The Independent JPEG Group for their JPEG software.
  68.  
  69.  
  70.       Michael Sinz (Operating System Development Group, Commodore-Amiga, Inc.)
  71.       for his WB2CLI routine and also for Enforcer.
  72.  
  73.  
  74.       Commodore-Amiga, Inc. for providing the one platform that I actually
  75.       enjoy using and programming on...
  76.  
  77.  
  78.  
  79. Section IV. - Installation
  80. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  81.  
  82.  
  83.    Method 1 - Installer Script
  84.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  85.  
  86.  
  87.       If you have Commodore's Installer© program (not included) in your path,
  88.       simply double click on the "Install-djpegGUI" icon and follow the 
  89.       instructions.
  90.  
  91.  
  92.  
  93.    Method 2 - Manual 
  94.    ~~~~~~~~~~~~~~~~~
  95.  
  96.  
  97.       Using the CLI or your favorite directory utility, copy the main
  98.       program files:
  99.  
  100.                            djpegGUI
  101.                            djpegGUI.info
  102.  
  103.       to a directory of your choice. Copy the documentation files:
  104.  
  105.                            djpegGUI.guide
  106.                            djpegGUI.guide.info
  107.  
  108.       if you have the AmigaGuide© hypertext system installed, else copy:
  109.  
  110.                            djpeg.doc
  111.                            djpeg.doc.info
  112.  
  113.       to a directory of your choice.
  114.  
  115.       You may also wish to configure the djpegGUI program to allow it to
  116.       find the "djpeg" program. djpegGUI will search your current
  117.       Workbench path for the "djpeg" program, however you may tell
  118.       djpegGUI where the "djpeg" program is located by setting the
  119.       tooltype DJPEGPATH in djpegGUI's icon. ie:
  120.  
  121.  
  122.                      DJPEGPATH=Work:Graphics/Tools/Jpeg
  123.  
  124.  
  125.       NOTE: Only specify the path, not a filename.
  126.  
  127.  
  128.       A path to the AmigaGuide© help file may also be specified if you
  129.       install the documentation in a different directory or rename the
  130.       file. example:
  131.  
  132.  
  133.                    HELP=Work:AmigaGuide/Files/djpegGUI.guide
  134.  
  135.  
  136.       NOTE: If the HELP tooltype is specified, you must include the
  137.             filename!
  138.  
  139.  
  140.       You can specify the window's opening position with the WINDOW
  141.       tooltype. The first number is the left or x coordinate, and the
  142.       second is the top or y coordinate. example:
  143.  
  144.  
  145.                               WINDOW=50/100
  146.  
  147.  
  148.       Would position the window 50 pixels to the left and 100 pixels down
  149.       from the top-left of the Workbench screen.
  150.  
  151.  
  152.  
  153. Section V. - Menus
  154. ~~~~~~~~~~~~~~~~~~
  155.  
  156.  
  157.    Project
  158.    ~~~~~~~
  159.  
  160.       About  (Amiga A) - Display a requester with program version, etc.
  161.       Quit   (Amiga Q) - Quit the program.
  162.  
  163.  
  164.  
  165. Section VI. - Gadgets
  166. ~~~~~~~~~~~~~~~~~~~~~
  167.  
  168.  
  169.    Source File - Specifies the JPEG file you wish to decompress. Clicking on
  170.                  the "Get" gadget will bring up the ASL file requester to
  171.                  allow you to select a file for this gadget. Dragging an
  172.                  icon into the djpegGUI window with an extension of .JPG,
  173.                  .JPEG, or .JFIF will place the filename of the icon in
  174.                  the string gadget.
  175.  
  176.  
  177.    Destination - Specifies the filename of the decompressed file. Any icon
  178.                  dragged onto the djpegGUI window without the file extensions
  179.                  mentioned above, will be placed in this string gadget.
  180.  
  181.    
  182.    Output      - This gadget allows you to select which file format you wish
  183.     Format       to use for the output file.
  184.  
  185.  
  186.    Reduce      - "djpeg" can dither the final number of colors in the
  187.     Colors To    output image. Selecting "Skip" will make "djpeg" skip
  188.                  the dithering process. Certain combinations of output format
  189.                  and number of colors are not legal, however djpegGUI will
  190.                  let you select them, "djpeg" will give you the appropriate
  191.                  error message(s) in this case. When "djpeg" reduces colors,
  192.                  Floyd-Steinberg dithering is applied to the image by default,
  193.                  however, this can be turned off. (See below)
  194.  
  195.  
  196.    Apply cross - Performs a smoothing process during decompression. This
  197.     block        is a slow and memory intensive process.
  198.      smoothing
  199.  
  200.  
  201.    Force       - Uses a gray-scale palette in the output image.
  202.     grayscale
  203.      output
  204.  
  205.  
  206.    Don't use   - Don't use Floyd-Steinberg when reducing the number of colors.
  207.     dithering
  208.  
  209.   
  210.    Use 1-pass  - Use one-pass instead of two-pass color quantization. The one-
  211.     quantization pass method is faster and needs less memory, but it produces
  212.                  a lower quality image.
  213.  
  214.  
  215.    Maximum     - Specify the maximum memory that "djpeg" should use during
  216.     Memory       decompression. (See Known Bugs)
  217.  
  218.  
  219.    Convert     - Starts the decompression process. Several checks such as
  220.                  overwriting a destination file, are performed before "djpeg"
  221.                  is called. An output window will open during the decompression
  222.                  and any error messages will be displayed here should "djpeg"
  223.                  fail for any reason.
  224.  
  225.  
  226.    Quit        - Quits :-)
  227.  
  228.  
  229.    Consult the djpeg.man file for more information regrading the various
  230.    options of "djpeg" listed above.
  231.  
  232.  
  233. Section VII. - Known Bugs
  234. ~~~~~~~~~~~~~~~~~~~~~~~~~
  235.  
  236.  
  237.    djpegGUI
  238.    ~~~~~~~~
  239.  
  240.    As far as I know, there are no bugs in this program. Enforcer was used
  241.    during developement and testing.
  242.    
  243.  
  244.  
  245.    djpeg
  246.    ~~~~~
  247.  
  248.    The version of "djpeg" that I used during developement of this program
  249.    ignors the Maximum Memory option (-m), therefore the Maximum Memory
  250.    gadget really has no effect. I've left this gadget in the program
  251.    in case future version of the "djpeg" program support this feature.
  252.  
  253.  
  254.    "djpeg" likes to have LOTS of memory for large images. 
  255.  
  256.  
  257.  
  258.    Other
  259.    ~~~~~
  260.  
  261.    Those of you running Enforcer will see a "hit" similar to the following
  262.    when the AmigaGuide© program is spawned to display the help.
  263.  
  264.    BYTE-READ from 00000000                        PC: 07F0D160                  
  265.    USP:  07ECAF2C SR: 0004 SW: 0751  (U0)(-)(-)  TCB: 07EC93E8                  
  266.    Data: 00000000 07C00010 80000000 00000000 40000000 80000000 07EC5B26 00000000
  267.    Addr: 00000001 00000000 07ECC434 07EC784C 07EC6480 07EC93E8 07C00810 --------
  268.    Stck: 80000000 00000000 07ECC434 07EC784C 07ECB390 07C00810 00000000 00000000
  269.    Stck: 07F01C24 00000000 00000000 07CB2FBE 07E99FC4 07EBF0E0 07EC5A9C 07E00EDC
  270.    ----> 07F0D160 - "LIBS:amigaguide.library"  Hunk 0000 Offset 0000BE50
  271.  
  272.    As far as I can tell, this seems to be a bug in the amigaguide.library.
  273.    I have not been able look into this problem due to problems with my CPR
  274.    installation. The code that spawns the AmigaGuide© has been taken
  275.    directly from a Commodore example and I don't believe it is the problem.
  276.    I will try to fix this in future versions.
  277.  
  278.  
  279. Section VIII. - Program History
  280. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  281.  
  282.  
  283.    Version 37.1 (25/07/93) - first public version
  284.  
  285.  
  286. Contacting the Author
  287. ~~~~~~~~~~~~~~~~~~~~~
  288.  
  289.  
  290.    If you have any comments, suggestions, gripes, or God forbid... bugs,
  291.    Please feel free to contact me at the following places:
  292.  
  293.  
  294.       Snail-Mail:  Geoff Seeley
  295.                    1240 Margaret Place,
  296.                    Duncan, British Columbia
  297.                    Canada
  298.                    V9L 4T6
  299.  
  300.  
  301.       E-Mail:      geoff@softwords.bc.ca
  302.       (InterNet)
  303.                    (put "djpegGUI" in your Subject: line for quick response)
  304.  
  305.